bmp2bin

## bmp2bin [Tool Command]

Turns bitmaps into binary.

### Syntax

    bmp2bin [-b/-p/-w/-h] input-file input-file ...

### Description

Converts bitmaps into binary and outputs the results.
Several things can be done with this tool: (1) the palette can be converted into binary and output, (2) the bitmap can be partitioned according to the size specifications and then divided and output in units of 8x8-dots so it can be used as object data, (3) 24bit images can be converted into binary and output in the color format for AGB, and (4) 8bit images can be output as-is for use in bitmap mode.

The command arguments are described below:

input-file
  The input bitmap file. One binary file is output for every bitmap entered.
-b
  Outputs in bitmap mode. If this argument is not specified, then 4bit and 8bit bitmaps will be output as objects (8x8 dots output as 1 character). For 24bit bitmaps the argument is set automatically.
-p
  Outputs the palette in binary. The image is not output. If an image without a palette is input an error will occur.
-w width
  The per-unit width of objects that are output. Can be specified as 8, 16, 32 or 64. If no value is specified it is set to 8 as the default. Invalid if the -b argument has been specified.
-h height
  The per-unit height of objects that are output. Can be specified as 8, 16, 32 or 64. If no value is specified it is set to 8 as the default. Invalid if the -b argument has been specified.

### Notes

Supports the 4bit, 4bit RLE-compressed, 8bit, 8bit RLE-compressed and 24bit image formats. 4bit images cannot be output as bitmaps. The output filename is set automatically using the base name of the input file and the appropriate extension. For palette output, the filename is given the `.plb` extension. For all other output, the name ends with the `.imb` extension. For object output, the `-w` and `-h` arguments are valid, and the image is first partitioned into parts of that size and then (to the AGB specifications) divided into 8x8 dots for output. Depending on `-w` `-h` the fractional part of the image will be enlarged.

AGB-06-0031-001A (2/26/01)
© 2001 Nintendo of America Inc.